=========================================================================
ISTRUZIONI per il TERZO ASSEGNAMENTO INFORMATICA anno 2015/16
========================================================================
L'assegnamento prevede la realizzazione di un insieme di funzioni per la ricostruzione di uno sciame di raggi cosmici ad alta energia (vedi ass3.pdf). 
Si richiede di realizzare il codice delle funzioni specificate in raggi.h.

------------------------------------------------
Estrarre il materiale dal KIT dell'assignment
------------------------------------------------
Creare una directory temporanea, copiare kit_a3.tar  
nella directory e spostarsi nella directory appena creata. Es.

$$ mkdir Assegnamento3
$$ mv kit_a3.tar Assegnamento3
$$ cd Assegnamento3

S-tarare i file del kit con

$$ tar xvf kit_a3.tar

questo comando crea nella directory corrente una directory "RAGGICOSMICI"
con i seguenti file

$$ ls RAGGICOSMICI
ass3.pdf		: specifiche dell'assegnamento


raggi.h		: dichiarazione delle funzioni da realizzare
raggi_docenti.c	: file con l'implementazione delle funzioni 
                          fornite dai docenti

test_*.c		: vari main di test
			(NON MODIFICARE)

gruppo.txt              : file di gruppo e script di verifica 
gruppo-check.pl		  (uguali a quelli del primo assegnamento)

Doxyfile
README.doxygen		: occorrente documentazione doxygen

README			: questo file

DATA/			: directory con i file di dati 
			(data.txt e data1.txt) e file di check 
                        utilizzati nei test 
                        (NON MODIFICARE IL CONTENUTO DELLA DIRECTORY)

========================================================================
ISTRUZIONI per la realizzazione dell'assegnamento
========================================================================

L'assegnamento prevede la realizzazione di alcune funzioni
definite in raggi.h e descritte in ass3.pdf.
Le funzioni devono essere sviluppate in un unico file raggi.c, eventualmente definendo altre funzioni ausiliarie.

Nel makefile sono automatizzati alcuni test.

Sviluppare le funzioni una alla volta testandole passo passo
con un oppotuno main().
Solo quando siamo ragionevolmente convinti della correttezza del
codice si puo' passare al testing automatico del codice con i test
forniti dai docenti.

Solo gli elaborati che passano i test possono essere consegnati.

------------------
Come procedere :
-----------------

1) leggere attentamente il file delle specifiche ass3.pdf (per
eventuali dubbi sulla parte fisica potete rivolgervi a Sgro' e
Baldini)

2) implementare e testare le funzioni richieste in un file raggi.c
seguendo la traccia degli esercizi

3) testare il software con i test forniti dai
  docenti (seguando la traccia in ass3.pdf). 

              
       

  NOTA: (1) il file raggi.c si deve trovare nella directory RAGGICOSMICI/
 
  (2) E' importante che i test forniti dai docenti vengano effettuati solo su
  funzioni gia' funzionanti e testate altrimenti i risultati
  possono essere di difficile interpretazione, fuorvianti o inutili.

4) preparare la documentazione: ovvero commentare adeguatamente raggi.c
   ed inserire una intestazione contenente il nome
   dello sviluppatore ed una dichiarazione di originalita' (questo e' IMPORTANTE per poter sempre attribuire i file ad u nautore in fase di correzione -- fateci attenzione)

   /** \file pippo.c
       \author Nino Bixio & Giuseppe Garibaldi
     Si dichiara che il contenuto di questo file e' in ogni sua parte opera
     originale delgli autori.  */

     Non e' richiesto di preparare anche la documentazione formato
     doxygen. Chi volesse farlo e' invitato a leggere il  README.doxigen.

6) aggiornare il file "gruppo.txt" con nomi e dati

7) consegnare il file ESCLUSIVAMENTE eseguendo

      bash:~$ make consegna

   e seguendo le istruzioni. 
   Il target consegna crea un file tar che deve essere inviato
   a susanna.pelagatti@gmail.com con subject

   "info16: consegna terzo assegnamento (primo anno)"
   se siete studenti del primo anno
   o
   "info16: consegna terzo assegnamento (secondo anno)"
   se siete studenti degli anni successivi

   Se il make non funziona nell'ambiente in cui state sviluppando, create
   un tar file con all'interno il file raggi.c e gruppo.txt ed 
   inviatelo al docente come sopra.

   Tutte le consegne verranno confermate con un messaggio entro 2/3
   giorni all'indirizzo da cui e' stata effettuata la consegna. In
   caso questo non si verifichi contattare il docente.
   

---------------------------------------
 NOTE IMPORTANTI: LEGGERE ATTENTAMENTE
---------------------------------------


1) tutti gli elaborati verranno confrontati fra di loro con tool automatici
   per stabilire eventuali situazioni di PLAGIO. Se gli elaborato sono 
   ragionevolmente simili verranno scartati.

2) Chi in sede di orale risulta palesemente non essere l'autore del software
   consegnato in uno degli assegnamenti dovra' ripetere l'esame

3) Tutti i comportamenti scorretti ai punti 1 e 2 verranno segnalati
   ufficialmente al presidente del corso di laurea

----------------------------
 VALUTAZIONE DELL'ASSEGNAMENTO:
----------------------------

Gli studenti che consegnano una versione funzionante e ragionevolmente corretta dell'assegnamento entro la data di scadenza accumulano un bonus di 2 punti che verra' sommato al voto finale (vedi lucidi lezioni ed esercitazioni).

La qualita' del codice consegnato e delle discussioni fornite per i 3 assegnamenti sara' valutata complessivamente da 0 a 30 e fara' media con il voto di scritto e orale.
